home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / inet / internet-drafts / draft-ietf-snmpv2-m2m-05.txt < prev    next >
Text File  |  1993-03-03  |  64KB  |  2,184 lines
  1.  
  2.  
  3.  
  4.  
  5.           Draft               Manager to Manager MIB              Dec 92
  6.  
  7.  
  8.                                 Manager to Manager
  9.                            Management Information Base
  10.  
  11.                              Tue Dec 22 13:43:46 1992                     |
  12.  
  13.  
  14.                                  Jeffrey D. Case
  15.                                SNMP Research, Inc.
  16.                         University of Tennessee, Knoxville
  17.                                  case@cs.utk.edu
  18.  
  19.  
  20.                                  Keith McCloghrie
  21.                                 Hughes LAN Systems
  22.                                    kzm@hls.com
  23.  
  24.  
  25.                                  Marshall T. Rose
  26.                            Dover Beach Consulting, Inc.
  27.                               mrose@dbc.mtview.ca.us
  28.  
  29.  
  30.                                Steven L. Waldbusser
  31.                             Carnegie Mellon University
  32.                             waldbusser@andrew.cmu.edu
  33.  
  34.  
  35.  
  36.  
  37.  
  38.                                Status of this Memo
  39.  
  40.           This document is an Internet Draft.  Internet Drafts are
  41.           working documents of the Internet Engineering Task Force
  42.           (IETF), its Areas, and its Working Groups.  Note that other
  43.           groups may also distribute working documents as Internet
  44.           Drafts.
  45.  
  46.           Internet Drafts are valid for a maximum of six months and may
  47.           be updated, replaced, or obsoleted by other documents at any
  48.           time.  It is inappropriate to use Internet Drafts as reference
  49.           material or to cite them other than as a "work in progress".
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                               Expires June 22, 1993             [Page 1]
  59.  
  60.  
  61.  
  62.  
  63.  
  64.           Draft               Manager to Manager MIB              Dec 92
  65.  
  66.  
  67.           1.  Introduction
  68.  
  69.           A network management system contains: several (potentially
  70.           many) nodes, each with a processing entity, termed an agent,
  71.           which has access to management instrumentation; at least one
  72.           management station; and, a management protocol, used to convey
  73.           management information between the agents and management
  74.           stations.  Operations of the protocol are carried out under an
  75.           administrative framework which defines both authentication and
  76.           authorization policies.
  77.  
  78.           Network management stations execute management applications
  79.           which monitor and control network elements.  Network elements
  80.           are devices such as hosts, routers, terminal servers, etc.,
  81.           which are monitored and controlled through access to their
  82.           management information.
  83.  
  84.           Management information is viewed as a collection of managed
  85.           objects, residing in a virtual information store, termed the
  86.           Management Information Base (MIB).  Collections of related
  87.           objects are defined in MIB modules.  These modules are written
  88.           using a subset of OSI's Abstract Syntax Notation One (ASN.1)
  89.           [1], termed the Structure of Management Information (SMI) [2].
  90.  
  91.           The management protocol, version 2 of the Simple Network
  92.           Management Protocol [3], provides for the exchange of messages
  93.           which convey management information between the agents and the
  94.           management stations, including between management stations.
  95.           It is the purpose of this document to define managed objects
  96.           which describe the behavior of a SNMPv2 entity acting in both
  97.           a manager role and an agent role.
  98.  
  99.  
  100.           1.1.  A Note on Terminology
  101.  
  102.           For the purpose of exposition, the original Internet-standard
  103.           Network Management Framework, as described in RFCs 1155, 1157,
  104.           and 1212, is termed the SNMP version 1 framework (SNMPv1).
  105.           The current framework is termed the SNMP version 2 framework
  106.           (SNMPv2).
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.                               Expires June 22, 1993             [Page 2]
  118.  
  119.  
  120.  
  121.  
  122.  
  123.           Draft               Manager to Manager MIB              Dec 92
  124.  
  125.  
  126.           2.  Overview
  127.  
  128.           The purpose of this MIB is to provide the means for
  129.           coordination between multiple management stations.  That is,
  130.           the means by which the controlling and monitoring functions of
  131.           network management can be distributed amongst multiple
  132.           management stations.  Such distribution facilitates the
  133.           scaling of network management solutions based on the SNMPv2 to
  134.           meet the needs of very large networks, or of networks composed
  135.           of multiple interconnected administrations. Specifically, this
  136.           MIB provides the means for one management station to request
  137.           management services from another management station.
  138.  
  139.  
  140.           2.1.  A SNMPv2 Entity Acting in a Dual Role
  141.  
  142.           A management station providing services to other management
  143.           station(s), is a SNMPv2 entity which acts in the dual role of
  144.           both manager and agent; the requests for service are received
  145.           through acting in an agent role (with respect to the managed
  146.           objects defined in this MIB), and the requested services are
  147.           performed through acting in a manager role.
  148.  
  149.  
  150.           2.2.  Alarms, Events, and Notifications
  151.  
  152.           In this initial version, this MIB defines the concepts of
  153.           "alarms", "events", and "notifications".  Each alarm is a
  154.           specific condition detected through the periodic (at a
  155.           configured sampling interval) monitoring of the value of a
  156.           specific management information variable.  An example of an
  157.           alarm condition is when the monitored variable falls outside a
  158.           configured range.  Each alarm condition triggers an event, and
  159.           each event can cause (one or more) notifications to be
  160.           reported to other management stations using the Inform-Request
  161.           PDU.
  162.  
  163.           Specifically, this MIB defines three MIB tables and a number
  164.           of scalar objects.  The three tables are: the Alarm Table, the
  165.           Event Table, and the Notification Table.
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.                               Expires June 22, 1993             [Page 3]
  177.  
  178.  
  179.  
  180.  
  181.  
  182.           Draft               Manager to Manager MIB              Dec 92
  183.  
  184.  
  185.           2.3.  Access Control
  186.  
  187.           The Administrative Model for SNMPv2 document [4] includes an
  188.           access control model, which must not be subverted by allowing
  189.           access to management information variables via the Alarm
  190.           table.  That is, access to a monitored variable via the Alarm
  191.           table must be controlled according to the identity of the
  192.           management station accessing the particular entry in the Alarm
  193.           table.
  194.  
  195.           An entry in the Alarm table provides the means to configure
  196.           the sampling of the value of a MIB variable in the MIB view
  197.           associated with the sampling destination party (which can be
  198.           either local or remote).  The sampling is done by
  199.           (conceptually or actually) issuing a SNMPv2 request to
  200.           retrieve the variable's value.  This request is authenticated
  201.           according to a source party, called the sampling source party
  202.           which must be local to the SNMPv2 entity acting in a dual
  203.           role, and directed to the sampling destination party.
  204.  
  205.           Thus, to provide the required access control, the initial MIB
  206.           view assigned, by convention, to parties on SNMPv2 entities
  207.           that implement the snmpAlarmTable, must include the component:
  208.  
  209.             viewSubtree  = { snmpAlarm }
  210.             viewStatus   = { excluded }
  211.             viewMask     = { ''H }
  212.  
  213.           Then, the MIB view of a party, partyRequestDest, accessible by
  214.           a requesting management station, can be configured to include
  215.           specific Alarm table entries -- the ones associated with those
  216.           sampling destination parties to which the requesting
  217.           management station has access.
  218.  
  219.           In particular, to provide a partyRequestDest with access to
  220.           the sampling destination party partySampleDest, the following
  221.           family of view subtrees would be included for partyRequestDest
  222.           on the SNMPv2 entity acting in a dual role:
  223.  
  224.                { snmpAlarmEntry WILDCARD partySampleDest }
  225.  
  226.           Which would be configured in the party MIB [5] as:
  227.  
  228.             viewParty    = { partyRequestDest }
  229.             viewSubtree  = { snmpAlarmEntry 1 partySampleDest }
  230.  
  231.  
  232.  
  233.  
  234.  
  235.                               Expires June 22, 1993             [Page 4]
  236.  
  237.  
  238.  
  239.  
  240.  
  241.           Draft               Manager to Manager MIB              Dec 92
  242.  
  243.  
  244.             viewStatus   = { included }
  245.             viewMask     = { 'FFBF'H } -- specifies wildcard for column
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.                               Expires June 22, 1993             [Page 5]
  295.  
  296.  
  297.  
  298.  
  299.  
  300.           Draft               Manager to Manager MIB              Dec 92
  301.  
  302.  
  303.           3.  Definitions
  304.  
  305.           SNMPv2-M2M-MIB DEFINITIONS ::= BEGIN
  306.  
  307.           IMPORTS
  308.               MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
  309.               Integer32, Counter32, snmpModules
  310.                   FROM SNMPv2-SMI
  311.               DisplayString, InstancePointer, RowStatus, TimeStamp
  312.                   FROM SNMPv2-TC
  313.               MODULE-COMPLIANCE, OBJECT-GROUP
  314.                   FROM SNMPv2-CONF
  315.               Party, partyIdentity
  316.                   FROM SNMPv2-PARTY-MIB;
  317.  
  318.  
  319.           snmpM2M MODULE-IDENTITY
  320.               LAST-UPDATED "9212222143Z"                                  |
  321.               ORGANIZATION "IETF SNMPv2 Working Group"
  322.               CONTACT-INFO
  323.                       "        Steven L. Waldbusser
  324.  
  325.                        Postal: Carnegie Mellon University
  326.                                UCC 130
  327.                                Pittsburgh, PA  15213
  328.  
  329.                           Tel: +1 412 268 6628
  330.                           Fax: +1 412 268 4987
  331.  
  332.                        E-mail: waldbusser@andrew.cmu.edu"
  333.               DESCRIPTION
  334.                       "The Manager to Manager MIB module."
  335.               ::= { snmpModules 2 }
  336.  
  337.  
  338.           snmpM2MObjects OBJECT IDENTIFIER     ::= { snmpM2M 1 }
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.                               Expires June 22, 1993             [Page 6]
  354.  
  355.  
  356.  
  357.  
  358.  
  359.           Draft               Manager to Manager MIB              Dec 92
  360.  
  361.  
  362.           -- the alarm group
  363.           --
  364.           -- a collection of objects allowing the description and
  365.           -- configuration of threshold alarms from a SNMPv2 entity
  366.           -- acting in a dual role.
  367.  
  368.           snmpAlarm OBJECT IDENTIFIER ::= { snmpM2MObjects 1 }
  369.  
  370.           -- This Alarm mechanism periodically takes statistical samples
  371.           -- from variables available via SNMPv2 and compares them to
  372.           -- thresholds that have been configured.  The alarm table
  373.           -- stores configuration entries that each define a variable,
  374.           -- polling period, and threshold parameters.  If a sample is
  375.           -- found to cross the threshold values, an event is generated.
  376.           -- Only variables that resolve to an ASN.1 primitive type of
  377.           -- INTEGER (Integer32, Counter32, Gauge32, TimeTicks,
  378.           -- Counter64, or UInteger32) may be monitored in this way.
  379.           --
  380.           -- This function has a hysteresis mechanism to limit the
  381.           -- generation of events.  This mechanism generates one event
  382.           -- as a threshold is crossed in the appropriate direction.  No
  383.           -- more events are generated for that threshold until the
  384.           -- opposite threshold is crossed.
  385.           --
  386.           -- In the case of sampling a deltaValue, an entity may
  387.           -- implement this mechanism with more precision if it takes a
  388.           -- delta sample twice per period, each time comparing the sum
  389.           -- of the latest two samples to the threshold.  This allows
  390.           -- the detection of threshold crossings that span the sampling
  391.           -- boundary.  Note that this does not require any special
  392.           -- configuration of the threshold value.  It is suggested that
  393.           -- entities implement this more precise algorithm.
  394.           --
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.                               Expires June 22, 1993             [Page 7]
  413.  
  414.  
  415.  
  416.  
  417.  
  418.           Draft               Manager to Manager MIB              Dec 92
  419.  
  420.  
  421.           snmpAlarmNextIndex OBJECT-TYPE
  422.               SYNTAX     INTEGER (0..65535)                               |
  423.               MAX-ACCESS read-only
  424.               STATUS     current
  425.               DESCRIPTION
  426.                       "The index number of the next appropriate
  427.                       unassigned entry in the snmpAlarmTable.  The value  +
  428.                       0 indicates that no unassigned entries are          +
  429.                       available.                                          +
  430.  
  431.                       A management station should create new entries in
  432.                       the snmpAlarmTable using this algorithm: first,
  433.                       issue a management protocol retrieval operation to
  434.                       determine the value of snmpAlarmNextIndex; and,
  435.                       second, issue a management protocol set operation
  436.                       to create an instance of the snmpAlarmStatus
  437.                       object setting its value to `underConstruction'.
  438.                       If this latter operation succeeds, then the
  439.                       management station may continue modifying the
  440.                       instances corresponding to the newly created
  441.                       conceptual row, without fear of collision with
  442.                       other management stations."
  443.               ::= { snmpAlarm 1 }
  444.  
  445.           snmpAlarmTable OBJECT-TYPE
  446.               SYNTAX     SEQUENCE OF SnmpAlarmEntry
  447.               MAX-ACCESS not-accessible
  448.               STATUS     current
  449.               DESCRIPTION
  450.                       "A list of snmpAlarm entries."
  451.               ::= { snmpAlarm 2 }
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.                               Expires June 22, 1993             [Page 8]
  472.  
  473.  
  474.  
  475.  
  476.  
  477.           Draft               Manager to Manager MIB              Dec 92
  478.  
  479.  
  480.           snmpAlarmEntry OBJECT-TYPE
  481.               SYNTAX     SnmpAlarmEntry
  482.               MAX-ACCESS not-accessible
  483.               STATUS     current
  484.               DESCRIPTION
  485.                       "A list of parameters that set up a periodic
  486.                       sampling query to check for alarm conditions.  The
  487.                       partyIdentity included in the INDEX clause is the
  488.                       sampling destination party, i.e., the party to
  489.                       which the sampling queries are directed."
  490.               INDEX      { partyIdentity, snmpAlarmIndex }
  491.               ::= { snmpAlarmTable 1 }
  492.  
  493.           SnmpAlarmEntry ::= SEQUENCE {
  494.               snmpAlarmIndex                    INTEGER,
  495.               snmpAlarmSourcePartyID            Party,
  496.               snmpAlarmVariable                 InstancePointer,
  497.               snmpAlarmInterval                 Integer32,
  498.               snmpAlarmSampleType               INTEGER,
  499.               snmpAlarmValue                    Integer32,
  500.               snmpAlarmStartupAlarm             INTEGER,
  501.               snmpAlarmRisingThreshold          Integer32,
  502.               snmpAlarmFallingThreshold         Integer32,
  503.               snmpAlarmRisingEventIndex         INTEGER,
  504.               snmpAlarmFallingEventIndex        INTEGER,
  505.               snmpAlarmUnavailableEventIndex    INTEGER,
  506.               snmpAlarmStatus                   RowStatus
  507.           }
  508.  
  509.           snmpAlarmIndex OBJECT-TYPE
  510.               SYNTAX     INTEGER (1..65535)
  511.               MAX-ACCESS not-accessible
  512.               STATUS     current
  513.               DESCRIPTION
  514.                       "An index that uniquely identifies an entry in the
  515.                       snmpAlarm table for a particular sampling
  516.                       destination party.  Each such entry defines a
  517.                       diagnostic sample at a particular interval for a
  518.                       variable in the particular party's MIB view."
  519.               ::= { snmpAlarmEntry 1 }
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.                               Expires June 22, 1993             [Page 9]
  531.  
  532.  
  533.  
  534.  
  535.  
  536.           Draft               Manager to Manager MIB              Dec 92
  537.  
  538.  
  539.           snmpAlarmSourcePartyID OBJECT-TYPE
  540.               SYNTAX     Party
  541.               MAX-ACCESS read-create
  542.               STATUS     current
  543.               DESCRIPTION
  544.                       "The sampling source party, i.e., the source party
  545.                       to be used to query the variable's value.  This
  546.                       party must be local to the SNMPv2 entity acting in
  547.                       a dual role."
  548.               ::= { snmpAlarmEntry 2 }
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.                               Expires June 22, 1993            [Page 10]
  590.  
  591.  
  592.  
  593.  
  594.  
  595.           Draft               Manager to Manager MIB              Dec 92
  596.  
  597.  
  598.           snmpAlarmVariable OBJECT-TYPE
  599.               SYNTAX     InstancePointer
  600.               MAX-ACCESS read-create
  601.               STATUS     current
  602.               DESCRIPTION
  603.                       "The object identifier of the particular variable
  604.                       to be sampled.  Only variables that resolve to an
  605.                       ASN.1 primitive type of INTEGER (Integer32,
  606.                       Counter32, Gauge32, TimeTicks, Counter64, or
  607.                       UInteger32) may be sampled.
  608.  
  609.                       If it is detected by an error response of
  610.                       authorizationError, noSuchObject, or
  611.                       noSuchInstance that the variable name of an
  612.                       established snmpAlarmEntry is no longer available
  613.                       to the sampling destination party, a single
  614.                       snmpObjectUnavailableAlarm event is generated and
  615.                       the status of this snmpAlarmEntry is changed to
  616.                       `underDestruction'.  Likewise, if the syntax of
  617.                       the variable retrieved by the query is not
  618.                       Integer32, Counter32, Gauge32, TimeTicks,
  619.                       Counter64, or UInteger32, the same actions will be
  620.                       taken.
  621.  
  622.                       If the SNMPv2 entity acting in a dual role detects
  623.                       that the sampled value can not be obtained due to
  624.                       lack of response to management queries, it should
  625.                       either:
  626.  
  627.                            1) Set the status of this snmpAlarmEntry to
  628.                            `underDestruction', if it is determined that
  629.                            further communication is not possible;
  630.  
  631.                            or,
  632.  
  633.                            2) Delete the associated snmpAlarmValue
  634.                            instance (but not the entire conceptual row),
  635.                            and continue to attempt to sample the
  636.                            variable and recreate the associated
  637.                            snmpAlarmValue instance should communication
  638.                            be reestablished.
  639.  
  640.                       An attempt to modify this object will fail with an
  641.                       `inconsistentValue' error if the associated
  642.                       snmpAlarmStatus object would be equal to `active'
  643.  
  644.  
  645.  
  646.  
  647.  
  648.                               Expires June 22, 1993            [Page 11]
  649.  
  650.  
  651.  
  652.  
  653.  
  654.           Draft               Manager to Manager MIB              Dec 92
  655.  
  656.  
  657.                       both before and after the modification attempt."
  658.               ::= { snmpAlarmEntry 3 }
  659.  
  660.           snmpAlarmInterval OBJECT-TYPE
  661.               SYNTAX     Integer32
  662.               UNITS      "seconds"
  663.               MAX-ACCESS read-create
  664.               STATUS     current
  665.               DESCRIPTION
  666.                       "The interval in seconds over which the data is
  667.                       sampled and compared with the rising and falling
  668.                       thresholds.  When setting this object and the
  669.                       sampling type is `deltaValue',  care should be
  670.                       taken to ensure that the change during this
  671.                       interval of the variable being sampled will not
  672.                       exceed the (-2^31...2^31-1) range of the
  673.                       snmpAlarmValue.
  674.  
  675.                       An attempt to modify this object will fail with an
  676.                       `inconsistentValue' error if the associated
  677.                       snmpAlarmStatus object would be equal to `active'
  678.                       both before and after the modification attempt."
  679.               ::= { snmpAlarmEntry 4 }
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.                               Expires June 22, 1993            [Page 12]
  708.  
  709.  
  710.  
  711.  
  712.  
  713.           Draft               Manager to Manager MIB              Dec 92
  714.  
  715.  
  716.           snmpAlarmSampleType OBJECT-TYPE
  717.               SYNTAX     INTEGER {
  718.                              absoluteValue(1),
  719.                              deltaValue(2)
  720.                          }
  721.               MAX-ACCESS read-create
  722.               STATUS     current
  723.               DESCRIPTION
  724.                       "The method of sampling the selected variable and
  725.                       calculating the value to be compared against the
  726.                       thresholds.  If the value of this object is
  727.                       `absoluteValue', the value of the selected
  728.                       variable at the end of the sampling interval will
  729.                       be compared directly with both the
  730.                       snmpAlarmRisingThreshold and the
  731.                       snmpAlarmFallingThreshold values.  If the value of
  732.                       this object is `deltaValue', the value of the
  733.                       selected variable at the end of the sampling
  734.                       interval will be subtracted from its value at the
  735.                       end of the previous sampling interval, and the
  736.                       difference compared with both the
  737.                       snmpAlarmRisingThreshold and the
  738.                       snmpAlarmFallingThreshold values.
  739.  
  740.                       An attempt to modify this object will fail with an
  741.                       `inconsistentValue' error if the associated
  742.                       snmpAlarmStatus object would be equal to `active'
  743.                       both before and after the modification attempt."
  744.               DEFVAL { deltaValue }
  745.               ::= { snmpAlarmEntry 5 }
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.                               Expires June 22, 1993            [Page 13]
  767.  
  768.  
  769.  
  770.  
  771.  
  772.           Draft               Manager to Manager MIB              Dec 92
  773.  
  774.  
  775.           snmpAlarmValue OBJECT-TYPE
  776.               SYNTAX     Integer32
  777.               MAX-ACCESS read-only
  778.               STATUS     current
  779.               DESCRIPTION
  780.                       "The value of the statistic during the last
  781.                       sampling period.  The value during the current
  782.                       sampling period is not made available until the
  783.                       period is completed.  If the value of the
  784.                       statistic does not fit in the signed 32 bit
  785.                       representation of this object, it should be
  786.                       truncated in an implementation specific manner.
  787.  
  788.                       Note that if the associated snmpAlarmSampleType is
  789.                       set to `deltaValue', the value of this object is
  790.                       the difference in the sampled variable since the
  791.                       last sample.
  792.  
  793.                       This object will be created by the SNMPv2 entity
  794.                       acting in a dual role when this entry is set to
  795.                       `active', and the first sampling period has
  796.                       completed.  It may be created and deleted at other
  797.                       times by the SNMPv2 entity acting in a dual role
  798.                       when the sampled value can not be obtained, as
  799.                       specified in the snmpAlarmVariable object."
  800.               ::= { snmpAlarmEntry 6 }
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.                               Expires June 22, 1993            [Page 14]
  826.  
  827.  
  828.  
  829.  
  830.  
  831.           Draft               Manager to Manager MIB              Dec 92
  832.  
  833.  
  834.           snmpAlarmStartupAlarm OBJECT-TYPE
  835.               SYNTAX     INTEGER {
  836.                              risingAlarm(1),
  837.                              fallingAlarm(2),
  838.                              risingOrFallingAlarm(3)
  839.                          }
  840.               MAX-ACCESS read-create
  841.               STATUS     current
  842.               DESCRIPTION
  843.                       "The alarm that may be sent when this entry is
  844.                       first set to `active'.  If the first sample after
  845.                       this entry becomes active is greater than or equal
  846.                       to the risingThreshold and snmpAlarmStartupAlarm
  847.                       is equal to `risingAlarm' or
  848.                       `risingOrFallingAlarm', then a single rising alarm
  849.                       will be generated.  If the first sample after this
  850.                       entry becomes active is less than or equal to the
  851.                       fallingThreshold and snmpAlarmStartupAlarm is
  852.                       equal to `fallingAlarm' or `risingOrFallingAlarm',
  853.                       then a single falling alarm will be generated.
  854.                       Note that a snmpObjectUnavailableAlarm is sent
  855.                       upon startup whenever it is applicable,
  856.                       independent of the setting of
  857.                       snmpAlarmStartupAlarm.
  858.  
  859.                       An attempt to modify this object will fail with an
  860.                       `inconsistentValue' error if the associated
  861.                       snmpAlarmStatus object would be equal to `active'
  862.                       both before and after the modification attempt."
  863.               DEFVAL { risingOrFallingAlarm }
  864.               ::= { snmpAlarmEntry 7 }
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.                               Expires June 22, 1993            [Page 15]
  885.  
  886.  
  887.  
  888.  
  889.  
  890.           Draft               Manager to Manager MIB              Dec 92
  891.  
  892.  
  893.           snmpAlarmRisingThreshold OBJECT-TYPE
  894.               SYNTAX     Integer32
  895.               MAX-ACCESS read-create
  896.               STATUS     current
  897.               DESCRIPTION
  898.                       "A threshold for the sampled statistic.  When the
  899.                       current sampled value is greater than or equal to
  900.                       this threshold, and the value at the last sampling
  901.                       interval was less than this threshold, a single
  902.                       event will be generated.  A single event will also
  903.                       be generated if the first sample after this entry
  904.                       becomes active is greater than or equal to this
  905.                       threshold and the associated snmpAlarmStartupAlarm
  906.                       is equal to `risingAlarm' or
  907.                       `risingOrFallingAlarm'.
  908.  
  909.                       After a rising event is generated, another such
  910.                       event will not be generated until the sampled
  911.                       value falls below this threshold and reaches the
  912.                       snmpAlarmFallingThreshold.
  913.  
  914.                       An attempt to modify this object will fail with an
  915.                       `inconsistentValue' error if the associated
  916.                       snmpAlarmStatus object would be equal to `active'
  917.                       both before and after the modification attempt."
  918.               ::= { snmpAlarmEntry 8 }
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.                               Expires June 22, 1993            [Page 16]
  944.  
  945.  
  946.  
  947.  
  948.  
  949.           Draft               Manager to Manager MIB              Dec 92
  950.  
  951.  
  952.           snmpAlarmFallingThreshold OBJECT-TYPE
  953.               SYNTAX     Integer32
  954.               MAX-ACCESS read-create
  955.               STATUS     current
  956.               DESCRIPTION
  957.                       "A threshold for the sampled statistic.  When the
  958.                       current sampled value is less than or equal to
  959.                       this threshold, and the value at the last sampling
  960.                       interval was greater than this threshold, a single
  961.                       event will be generated.  A single event will also
  962.                       be generated if the first sample after this entry
  963.                       becomes active is less than or equal to this
  964.                       threshold and the associated snmpAlarmStartupAlarm
  965.                       is equal to `fallingAlarm' or
  966.                       `risingOrFallingAlarm'.
  967.  
  968.                       After a falling event is generated, another such
  969.                       event will not be generated until the sampled
  970.                       value rises above this threshold and reaches the
  971.                       snmpAlarmRisingThreshold.
  972.  
  973.                       An attempt to modify this object will fail with an
  974.                       `inconsistentValue' error if the associated
  975.                       snmpAlarmStatus object would be equal to `active'
  976.                       both before and after the modification attempt."
  977.               ::= { snmpAlarmEntry 9 }
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.                               Expires June 22, 1993            [Page 17]
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.           Draft               Manager to Manager MIB              Dec 92
  1009.  
  1010.  
  1011.           snmpAlarmRisingEventIndex OBJECT-TYPE
  1012.               SYNTAX     INTEGER (0..65535)
  1013.               MAX-ACCESS read-create
  1014.               STATUS     current
  1015.               DESCRIPTION
  1016.                       "The index of the snmpEventEntry that is used when
  1017.                       a rising threshold is crossed.  The snmpEventEntry
  1018.                       identified by a particular value of this index is
  1019.                       the same as identified by the same value of the
  1020.                       snmpEventIndex object.  If there is no
  1021.                       corresponding entry in the snmpEventTable, then no
  1022.                       association exists.  In particular, if this value
  1023.                       is zero, no associated event will be generated, as
  1024.                       zero is not a valid snmpEventIndex.
  1025.  
  1026.                       An attempt to modify this object will fail with an
  1027.                       `inconsistentValue' error if the associated
  1028.                       snmpAlarmStatus object would be equal to `active'
  1029.                       both before and after the modification attempt."
  1030.               ::= { snmpAlarmEntry 10 }
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.                               Expires June 22, 1993            [Page 18]
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.           Draft               Manager to Manager MIB              Dec 92
  1068.  
  1069.  
  1070.           snmpAlarmFallingEventIndex OBJECT-TYPE
  1071.               SYNTAX     INTEGER (0..65535)
  1072.               MAX-ACCESS read-create
  1073.               STATUS     current
  1074.               DESCRIPTION
  1075.                       "The index of the snmpEventEntry that is used when
  1076.                       a falling threshold is crossed.  The
  1077.                       snmpEventEntry identified by a particular value of
  1078.                       this index is the same as identified by the same
  1079.                       value of the snmpEventIndex object.  If there is
  1080.                       no corresponding entry in the snmpEventTable, then
  1081.                       no association exists.  In particular, if this
  1082.                       value is zero, no associated event will be
  1083.                       generated, as zero is not a valid snmpEventIndex.
  1084.  
  1085.                       An attempt to modify this object will fail with an
  1086.                       `inconsistentValue' error if the associated
  1087.                       snmpAlarmStatus object would be equal to `active'
  1088.                       both before and after the modification attempt."
  1089.               ::= { snmpAlarmEntry 11 }
  1090.  
  1091.           snmpAlarmUnavailableEventIndex OBJECT-TYPE
  1092.               SYNTAX     INTEGER (0..65535)
  1093.               MAX-ACCESS read-create
  1094.               STATUS     current
  1095.               DESCRIPTION
  1096.                       "The index of the snmpEventEntry that is used when
  1097.                       a variable becomes unavailable.  The
  1098.                       snmpEventEntry identified by a particular value of
  1099.                       this index is the same as identified by the same
  1100.                       value of the snmpEventIndex object.  If there is
  1101.                       no corresponding entry in the snmpEventTable, then
  1102.                       no association exists.  In particular, if this
  1103.                       value is zero, no associated event will be
  1104.                       generated, as zero is not a valid snmpEventIndex.
  1105.  
  1106.                       An attempt to modify this object will fail with an
  1107.                       `inconsistentValue' error if the associated
  1108.                       snmpAlarmStatus object would be equal to `active'
  1109.                       both before and after the modification attempt."
  1110.               ::= { snmpAlarmEntry 12 }
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.  
  1120.                               Expires June 22, 1993            [Page 19]
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.           Draft               Manager to Manager MIB              Dec 92
  1127.  
  1128.  
  1129.           snmpAlarmStatus OBJECT-TYPE
  1130.               SYNTAX     RowStatus
  1131.               MAX-ACCESS read-create
  1132.               STATUS     current
  1133.               DESCRIPTION
  1134.                       "The status of this snmpAlarm entry.  This object
  1135.                       may not be set to `active' unless the following
  1136.                       columnar objects exist in this row:
  1137.                       snmpAlarmSourcePartyID, snmpAlarmVariable,
  1138.                       snmpAlarmInterval, snmpAlarmSampleType,
  1139.                       snmpAlarmStartupAlarm, snmpAlarmRisingThreshold,
  1140.                       snmpAlarmFallingThreshold,
  1141.                       snmpAlarmRisingEventIndex,
  1142.                       snmpAlarmFallingEventIndex, and
  1143.                       snmpAlarmUnavailableEventIndex."
  1144.               ::= { snmpAlarmEntry 13 }
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.                               Expires June 22, 1993            [Page 20]
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.           Draft               Manager to Manager MIB              Dec 92
  1186.  
  1187.  
  1188.           -- alarm-related notifications
  1189.  
  1190.           snmpAlarmNotifications OBJECT IDENTIFIER ::= { snmpAlarm 3 }
  1191.  
  1192.           snmpRisingAlarm NOTIFICATION-TYPE
  1193.               OBJECTS { snmpAlarmVariable, snmpAlarmSampleType, snmpAlarmValue,
  1194.                         snmpAlarmRisingThreshold }
  1195.               STATUS  current
  1196.               DESCRIPTION
  1197.                       "An event that is generated when an alarm entry
  1198.                       crosses its rising threshold.  The instances of
  1199.                       those objects contained within the varbind list
  1200.                       are those of the alarm entry which generated this
  1201.                       event."
  1202.               ::= { snmpAlarmNotifications 1 }
  1203.  
  1204.           snmpFallingAlarm NOTIFICATION-TYPE
  1205.               OBJECTS { snmpAlarmVariable, snmpAlarmSampleType, snmpAlarmValue,
  1206.                         snmpAlarmFallingThreshold }
  1207.               STATUS  current
  1208.               DESCRIPTION
  1209.                       "An event that is generated when an alarm entry
  1210.                       crosses its falling threshold.  The instances of
  1211.                       those objects contained within the varbind list
  1212.                       are those of the alarm entry which generated this
  1213.                       event."
  1214.               ::= { snmpAlarmNotifications 2 }
  1215.  
  1216.           snmpObjectUnavailableAlarm NOTIFICATION-TYPE
  1217.               OBJECTS { snmpAlarmVariable }
  1218.               STATUS  current
  1219.               DESCRIPTION
  1220.                       "An event that is generated when a variable
  1221.                       monitored by an alarm entry becomes unavailable.
  1222.                       The instance of snmpAlarmVariable contained within
  1223.                       the varbind list is the one associated with the
  1224.                       alarm entry which generated this event."
  1225.               ::= { snmpAlarmNotifications 3 }
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.                               Expires June 22, 1993            [Page 21]
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.           Draft               Manager to Manager MIB              Dec 92
  1245.  
  1246.  
  1247.           -- the event group
  1248.           --
  1249.           -- a collection of objects allowing the description and
  1250.           -- configuration of events from a SNMPv2 entity acting in a dual role.
  1251.  
  1252.           snmpEvent OBJECT IDENTIFIER ::= { snmpM2MObjects 2 }
  1253.  
  1254.           -- The snmpEvent table defines the set of events generated on
  1255.           -- a SNMPv2 entity acting in a dual role.  Each entry in the
  1256.           -- snmpEventTable associates an event type with the
  1257.           -- notification method and associated parameters.  Some
  1258.           -- snmpEvent entries are fired by an associated condition in
  1259.           -- the snmpAlarmTable.  Others are fired on behalf of
  1260.           -- conditions defined in the NOTIFICATION-TYPE macro.  The
  1261.           -- snmpNotificationTable defines notifications that should
  1262.           -- occur when an associated event is fired.
  1263.  
  1264.           snmpEventNextIndex OBJECT-TYPE
  1265.               SYNTAX     INTEGER (0..65535)                               |
  1266.               MAX-ACCESS read-only
  1267.               STATUS     current
  1268.               DESCRIPTION
  1269.                       "The index number of the next appropriate
  1270.                       unassigned entry in the snmpEventTable.  The value  +
  1271.                       0 indicates that no unassigned entries are          +
  1272.                       available.                                          +
  1273.  
  1274.                       A management station should create new entries in
  1275.                       the snmpEventTable using this algorithm: first,
  1276.                       issue a management protocol retrieval operation to
  1277.                       determine the value of snmpEventNextIndex; and,
  1278.                       second, issue a management protocol set operation
  1279.                       to create an instance of the snmpEventStatus
  1280.                       object setting its value to `underConstruction'.
  1281.                       If this latter operation succeeds, then the
  1282.                       management station may continue modifying the
  1283.                       instances corresponding to the newly created
  1284.                       conceptual row, without fear of collision with
  1285.                       other management stations."
  1286.               ::= { snmpEvent 1 }
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.                               Expires June 22, 1993            [Page 22]
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.           Draft               Manager to Manager MIB              Dec 92
  1304.  
  1305.  
  1306.           snmpEventTable OBJECT-TYPE
  1307.               SYNTAX     SEQUENCE OF SnmpEventEntry
  1308.               MAX-ACCESS not-accessible
  1309.               STATUS     current
  1310.               DESCRIPTION
  1311.                       "A list of events."
  1312.               ::= { snmpEvent 2 }
  1313.  
  1314.           snmpEventEntry OBJECT-TYPE
  1315.               SYNTAX     SnmpEventEntry
  1316.               MAX-ACCESS not-accessible
  1317.               STATUS     current
  1318.               DESCRIPTION
  1319.                       "A set of parameters that describe an event that
  1320.                       is generated when certain conditions are met."
  1321.               INDEX      { snmpEventIndex }
  1322.               ::= { snmpEventTable 1 }
  1323.  
  1324.           SnmpEventEntry ::= SEQUENCE {
  1325.               snmpEventIndex          INTEGER,
  1326.               snmpEventID             OBJECT IDENTIFIER,
  1327.               snmpEventDescription    DisplayString,
  1328.               snmpEventEvents         Counter32,
  1329.               snmpEventLastTimeSent   TimeStamp,
  1330.               snmpEventStatus         RowStatus
  1331.           }
  1332.  
  1333.           snmpEventIndex OBJECT-TYPE
  1334.               SYNTAX     INTEGER (1..65535)
  1335.               MAX-ACCESS not-accessible
  1336.               STATUS     current
  1337.               DESCRIPTION
  1338.                       "An index that uniquely identifies an entry in the
  1339.                       snmpEvent table.  Each such entry defines an event
  1340.                       generated when the appropriate conditions occur."
  1341.               ::= { snmpEventEntry 1 }
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.                               Expires June 22, 1993            [Page 23]
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.           Draft               Manager to Manager MIB              Dec 92
  1363.  
  1364.  
  1365.           snmpEventID OBJECT-TYPE
  1366.               SYNTAX     OBJECT IDENTIFIER
  1367.               MAX-ACCESS read-create
  1368.               STATUS     current
  1369.               DESCRIPTION
  1370.                       "The authoritative identification of the event
  1371.                       type generated by this entry.  This variable        |
  1372.                       occurs as the second varbind of an                  |
  1373.                       InformRequest-PDU.  If this OBJECT IDENTIFIER maps
  1374.                       to a NOTIFICATION-TYPE the sender will place the
  1375.                       objects listed in the NOTIFICATION-TYPE in the
  1376.                       varbind list."
  1377.               ::= { snmpEventEntry 2 }
  1378.  
  1379.           snmpEventDescription OBJECT-TYPE
  1380.               SYNTAX     DisplayString (SIZE (0..127))
  1381.               MAX-ACCESS read-create
  1382.               STATUS     current
  1383.               DESCRIPTION
  1384.                       "A comment describing this snmpEvent entry."
  1385.               ::= { snmpEventEntry 3 }
  1386.  
  1387.           snmpEventEvents OBJECT-TYPE
  1388.               SYNTAX     Counter32
  1389.               MAX-ACCESS read-only
  1390.               STATUS     current
  1391.               DESCRIPTION
  1392.                       "The number of events caused by event generators
  1393.                       associated with this snmpEvent entry."
  1394.               ::= { snmpEventEntry 4 }
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.                               Expires June 22, 1993            [Page 24]
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.           Draft               Manager to Manager MIB              Dec 92
  1422.  
  1423.  
  1424.           snmpEventLastTimeSent OBJECT-TYPE
  1425.               SYNTAX     TimeStamp
  1426.               MAX-ACCESS read-only
  1427.               STATUS     current
  1428.               DESCRIPTION
  1429.                       "The value of sysUpTime at the time this snmpEvent
  1430.                       entry last generated an event.  If this entry has
  1431.                       not generated any events, this value will be
  1432.                       zero."
  1433.               DEFVAL { 0 }
  1434.               ::= { snmpEventEntry 5 }
  1435.  
  1436.           snmpEventStatus OBJECT-TYPE
  1437.               SYNTAX     RowStatus
  1438.               MAX-ACCESS read-create
  1439.               STATUS     current
  1440.               DESCRIPTION
  1441.                       "The status of this snmpEvent entry.  This object
  1442.                       may not be set to `active' unless the following
  1443.                       columnar objects exist in this row: snmpEventID,
  1444.                       snmpEventDescription, snmpEventEvents, and
  1445.                       snmpEventLastTimeSent.
  1446.  
  1447.                       Setting an instance of this object to the value
  1448.                       any/all entries in the snmpEventTable, and the
  1449.                       snmpEventNotifyTable which reference the
  1450.                       corresponding snmpEventEntry."
  1451.               ::= { snmpEventEntry 6 }
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.                               Expires June 22, 1993            [Page 25]
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.           Draft               Manager to Manager MIB              Dec 92
  1481.  
  1482.  
  1483.           snmpEventNotifyMinInterval OBJECT-TYPE
  1484.               SYNTAX     Integer32
  1485.               UNITS      "seconds"
  1486.               MAX-ACCESS read-only
  1487.               STATUS     current
  1488.               DESCRIPTION
  1489.                       "The minimum interval that the SNMPv2 entity
  1490.                       acting in a dual role will wait before
  1491.                       retransmitting an InformRequest-PDU.  This object
  1492.                       specifies the minimal value supported by the
  1493.                       SNMPv2 entity acting in a dual role, based on
  1494.                       resource or implementation constraints.
  1495.  
  1496.                       For a particular entry in the
  1497.                       snmpEventNotifyTable, if the associated
  1498.                       snmpEventNotifyIntervalRequested variable is
  1499.                       greater than this object, the
  1500.                       snmpEventNotifyIntervalRequested value shall be
  1501.                       used as the minimum interval for retransmissions
  1502.                       of InformRequest-PDUs sent on behalf of that
  1503.                       entry."
  1504.               ::= { snmpEvent 3 }
  1505.  
  1506.           snmpEventNotifyMaxRetransmissions OBJECT-TYPE
  1507.               SYNTAX     Integer32
  1508.               MAX-ACCESS read-only
  1509.               STATUS     current
  1510.               DESCRIPTION
  1511.                       "The maximum number of time that the SNMPv2 entity
  1512.                       acting in a dual role will retransmit an
  1513.                       InformRequest-PDU.  This object specifies the
  1514.                       maximal value supported by the SNMPv2 entity
  1515.                       acting in a dual role, based on resource or
  1516.                       implementation constraints.
  1517.  
  1518.                       For a particular entry in the
  1519.                       snmpEventNotifyTable, if the associated
  1520.                       snmpEventNotifyRetransmissionsRequested variable
  1521.                       is less than this object, the
  1522.                       snmpEventNotifyRetransmissionsRequested value
  1523.                       shall be used as the retransmission count for
  1524.                       InformRequest-PDUs sent on behalf of that entry."
  1525.               ::= { snmpEvent 4 }
  1526.  
  1527.           -- The snmpEventNotifyTable is used to configure the
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.                               Expires June 22, 1993            [Page 26]
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.           Draft               Manager to Manager MIB              Dec 92
  1540.  
  1541.  
  1542.           -- destination and type of notifications sent by a SNMPv2
  1543.           -- entity acting in a manager role when a particular event
  1544.           -- is triggered.
  1545.  
  1546.           snmpEventNotifyTable OBJECT-TYPE
  1547.               SYNTAX     SEQUENCE OF SnmpEventNotifyEntry
  1548.               MAX-ACCESS not-accessible
  1549.               STATUS     current
  1550.               DESCRIPTION
  1551.                       "A list of protocol configuration entries for
  1552.                       event notifications from this entity."
  1553.               ::= { snmpEvent 5 }
  1554.  
  1555.           snmpEventNotifyEntry OBJECT-TYPE
  1556.               SYNTAX     SnmpEventNotifyEntry
  1557.               MAX-ACCESS not-accessible
  1558.               STATUS     current
  1559.               DESCRIPTION
  1560.                       "A set of parameters that describe the type and
  1561.                       destination of InformRequest-PDUs sent for a
  1562.                       particular event.  The snmpEventIndex in this
  1563.                       entry's INDEX clause identifies the snmpEventEntry
  1564.                       which, when triggered, will generate a
  1565.                       notification as configured in this entry.  The
  1566.                       partyIdentity in this entry's INDEX clause
  1567.                       identifies the destination party to which a
  1568.                       notification will be sent."
  1569.               INDEX      { snmpEventIndex, partyIdentity }
  1570.               ::= { snmpEventNotifyTable 1 }
  1571.  
  1572.           SnmpEventNotifyEntry ::= SEQUENCE {
  1573.               snmpEventNotifySrcParty                 Party,
  1574.               snmpEventNotifyIntervalRequested        Integer32,
  1575.               snmpEventNotifyRetransmissionsRequested Integer32,
  1576.               snmpEventNotifyLifetime                 Integer32,
  1577.               snmpEventNotifyStatus                   RowStatus
  1578.           }
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.                               Expires June 22, 1993            [Page 27]
  1593.  
  1594.  
  1595.  
  1596.  
  1597.  
  1598.           Draft               Manager to Manager MIB              Dec 92
  1599.  
  1600.  
  1601.           snmpEventNotifySrcParty OBJECT-TYPE
  1602.               SYNTAX     Party
  1603.               MAX-ACCESS read-create
  1604.               STATUS     current
  1605.               DESCRIPTION
  1606.                       "The source party to be used to send the
  1607.                       InformRequest-PDU."
  1608.               ::= { snmpEventNotifyEntry 1 }
  1609.  
  1610.           snmpEventNotifyIntervalRequested OBJECT-TYPE
  1611.               SYNTAX     Integer32
  1612.               UNITS      "seconds"
  1613.               MAX-ACCESS read-create
  1614.               STATUS     current
  1615.               DESCRIPTION
  1616.                       "The requested interval for retransmission of
  1617.                       Inform PDUs generated on the behalf of this entry.
  1618.  
  1619.                       This variable will be the actual interval used
  1620.                       unless the snmpEventNotifyMinInterval is greater
  1621.                       than this object, in which case the interval shall
  1622.                       be equal to snmpEventNotifyMinInterval."
  1623.               DEFVAL { 30 }
  1624.               ::= { snmpEventNotifyEntry 2 }
  1625.  
  1626.           snmpEventNotifyRetransmissionsRequested OBJECT-TYPE
  1627.               SYNTAX     Integer32
  1628.               MAX-ACCESS read-create
  1629.               STATUS     current
  1630.               DESCRIPTION
  1631.                       "The requested number of retransmissions of an
  1632.                       InformRequest-PDU generated on behalf of this
  1633.                       entry.
  1634.  
  1635.                       This variable will be the actual number of
  1636.                       retransmissions used unless the
  1637.                       snmpEventNotifyMaxRetransmissions is less than
  1638.                       this object, in which case the retransmission
  1639.                       count shall be equal to
  1640.                       snmpEventNotifyMaxRetransmissions."
  1641.               DEFVAL { 5 }
  1642.               ::= { snmpEventNotifyEntry 3 }
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.                               Expires June 22, 1993            [Page 28]
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.           Draft               Manager to Manager MIB              Dec 92
  1658.  
  1659.  
  1660.           snmpEventNotifyLifetime OBJECT-TYPE
  1661.               SYNTAX     Integer32
  1662.               UNITS      "seconds"
  1663.               MAX-ACCESS read-create
  1664.               STATUS     current
  1665.               DESCRIPTION
  1666.                       "The number of seconds this entry shall live until
  1667.                       it is put into the underDestruction state.  This
  1668.                       value shall count down to zero, at which time the
  1669.                       status of this entry will be changed to
  1670.                       underDestruction.  Any management station that is
  1671.                       using this entry must periodically refresh this
  1672.                       value to ensure the continued delivery of events."
  1673.               DEFVAL { 86400 }
  1674.               ::= { snmpEventNotifyEntry 4 }
  1675.  
  1676.           snmpEventNotifyStatus OBJECT-TYPE
  1677.               SYNTAX     RowStatus
  1678.               MAX-ACCESS read-create
  1679.               STATUS     current
  1680.               DESCRIPTION
  1681.                       "The state of this snmpEventNotifyEntry.  This
  1682.                       object may not be set to `active' unless the
  1683.                       following columnar objects exist in this row:
  1684.                       snmpEventNotifySrcParty,
  1685.                       snmpEventNotifyIntervalRequested,
  1686.                       snmpEventNotifyRetransmissionsRequested, and
  1687.                       snmpEventNotifyLifetime."
  1688.               ::= { snmpEventNotifyEntry 5 }
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.                               Expires June 22, 1993            [Page 29]
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.           Draft               Manager to Manager MIB              Dec 92
  1717.  
  1718.  
  1719.           -- conformance information
  1720.  
  1721.           snmpM2MConformance OBJECT IDENTIFIER ::= { snmpM2M 2 }
  1722.  
  1723.           snmpM2MCompliances OBJECT IDENTIFIER ::= { snmpM2MConformance 1 }
  1724.           snmpM2MGroups      OBJECT IDENTIFIER ::= { snmpM2MConformance 2 }
  1725.  
  1726.  
  1727.           -- compliance statements
  1728.  
  1729.           snmpM2MCompliance MODULE-COMPLIANCE
  1730.               STATUS  current
  1731.               DESCRIPTION
  1732.                       "The compliance statement for SNMPv2 entities
  1733.                       which implement the Manager to Manager MIB."
  1734.               MODULE  -- this module
  1735.                   MANDATORY-GROUPS { snmpAlarmGroup, snmpEventGroup }
  1736.               ::= { snmpM2MCompliances 1 }
  1737.  
  1738.  
  1739.           -- units of conformance                                         |
  1740.  
  1741.           snmpAlarmGroup OBJECT-GROUP
  1742.               OBJECTS { snmpAlarmNextIndex,
  1743.                         snmpAlarmSourcePartyID,
  1744.                         snmpAlarmVariable, snmpAlarmInterval,
  1745.                         snmpAlarmSampleType, snmpAlarmValue,
  1746.                         snmpAlarmStartupAlarm, snmpAlarmRisingThreshold,
  1747.                         snmpAlarmFallingThreshold,
  1748.                         snmpAlarmRisingEventIndex,
  1749.                         snmpAlarmFallingEventIndex,
  1750.                         snmpAlarmUnavailableEventIndex,
  1751.                         snmpAlarmStatus }
  1752.               STATUS  current
  1753.               DESCRIPTION
  1754.                       "A collection of objects allowing the description
  1755.                       and configuration of threshold alarms from a
  1756.                       SNMPv2 entity acting in a dual role."
  1757.               ::= { snmpM2MGroups 1 }
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.                               Expires June 22, 1993            [Page 30]
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.           Draft               Manager to Manager MIB              Dec 92
  1776.  
  1777.  
  1778.           snmpEventGroup OBJECT-GROUP
  1779.               OBJECTS { snmpEventNextIndex,
  1780.                         snmpEventID, snmpEventDescription,
  1781.                         snmpEventEvents, snmpEventLastTimeSent,
  1782.                         snmpEventStatus, snmpEventNotifyMinInterval,
  1783.                         snmpEventNotifyMaxRetransmissions,
  1784.                         snmpEventNotifySrcParty,
  1785.                         snmpEventNotifyIntervalRequested,
  1786.                         snmpEventNotifyRetransmissionsRequested,
  1787.                         snmpEventNotifyLifetime, snmpEventNotifyStatus }
  1788.               STATUS  current
  1789.               DESCRIPTION
  1790.                       "A collection of objects allowing the description
  1791.                       and configuration of events from a SNMPv2 entity
  1792.                       acting in a dual role."
  1793.               ::= { snmpM2MGroups 2 }
  1794.  
  1795.  
  1796.           END
  1797.  
  1798.  
  1799.  
  1800.  
  1801.  
  1802.  
  1803.  
  1804.  
  1805.  
  1806.  
  1807.  
  1808.  
  1809.  
  1810.  
  1811.  
  1812.  
  1813.  
  1814.  
  1815.  
  1816.  
  1817.  
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.                               Expires June 22, 1993            [Page 31]
  1829.  
  1830.  
  1831.  
  1832.  
  1833.  
  1834.           Draft               Manager to Manager MIB              Dec 92
  1835.  
  1836.  
  1837.           4.  Acknowledgements
  1838.  
  1839.           The comments of the SNMP version 2 working group are
  1840.           gratefully acknowledged:
  1841.  
  1842.                Beth Adams, Network Management Forum
  1843.                Steve Alexander, INTERACTIVE Systems Corporation
  1844.                David Arneson, Cabletron Systems
  1845.                Toshiya Asaba,
  1846.                Fred Baker, ACC
  1847.                Jim Barnes, Xylogics, Inc.
  1848.                Brian Bataille
  1849.                Andy Bierman, SynOptics Communications, Inc.
  1850.                Uri Blumenthal, IBM Corporation
  1851.                Fred Bohle, Interlink
  1852.                Jack Brown
  1853.                Theodore Brunner, Bellcore
  1854.                Stephen F. Bush, GE Information Services
  1855.                Deirdre C. Kostik, Bellcore
  1856.                Jeff Case, University of Tennessee, Knoxville
  1857.                John Chang, IBM Corporation
  1858.                Szusin Chen, Sun Microsystems
  1859.                Robert Ching
  1860.                Chris Chiotasso, Ungermann-Bass
  1861.                Bobby A. Clay, NASA/Boeing
  1862.                John Cooke, Chipcom
  1863.                Tracy Cox, Bellcore
  1864.                Juan Cruz, Datability, Inc.
  1865.                David Cullerot, Cabletron Systems
  1866.                Cathy Cunningham, Microcom
  1867.                James R. (Chuck) Davin, Bellcore
  1868.                Michael Davis, Clearpoint
  1869.                Mike Davison, FiberCom
  1870.                Cynthia DellaTorre, MITRE
  1871.                Taso N. Devetzis, Bellcore
  1872.                Manual Diaz, DAVID Systems, Inc.
  1873.                Jon Dreyer, Sun Microsystems
  1874.                Susan E. Hicks, Martin Marietta Energy Systems
  1875.                David Engel, Optical Data Systems
  1876.                Mike Erlinger, Lexcel
  1877.                Roger Fajman, NIH
  1878.                Daniel Fauvarque, Sun Microsystems
  1879.                Karen Frisa, CMU
  1880.                Shari Galitzer, MITRE
  1881.                Shawn Gallagher, Digital Equipment Corporation
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887.                               Expires June 22, 1993            [Page 32]
  1888.  
  1889.  
  1890.  
  1891.  
  1892.  
  1893.           Draft               Manager to Manager MIB              Dec 92
  1894.  
  1895.  
  1896.                Richard Graveman, Bellcore
  1897.                Maria Greene, Xyplex, Inc.
  1898.                Michel Guittet, Apple
  1899.                Robert Gutierrez, NASA
  1900.                Bill Hagerty, Cabletron Systems
  1901.                Gary W. Haney, Martin Marietta Energy Systems
  1902.                Patrick Hanil, Nokia Telecommunications
  1903.                Matt Hecht, SNMP Research, Inc.
  1904.                Edward A. Heiner, Jr., Synernetics Inc.
  1905.                Geral Holzhauer, Apple
  1906.                John Hopprich, DAVID Systems, Inc.
  1907.                Jeff Hughes, Hewlett-Packard
  1908.                Robin Iddon, Axon Networks, Inc.
  1909.                David Itusak
  1910.                Kevin M. Jackson, Concord Communications, Inc.
  1911.                Ole J. Jacobsen, Interop Company
  1912.                Ronald Jacoby, Silicon Graphics, Inc.
  1913.                Satish Joshi, SynOptics Communications, Inc.
  1914.                Frank Kastenholz, FTP Software
  1915.                Mark Kepke, Hewlett-Packard
  1916.                Ken Key, SNMP Research, Inc.
  1917.                Zbiginew Kielczewski, Eicon
  1918.                Jongyeoi Kim
  1919.                Andrew Knutsen, The Santa Cruz Operation
  1920.                Michael L Kornegay, VisiSoft
  1921.                Cheryl Krupczak, Georgia Tech
  1922.                Steven L. Waldbusser, Carnegie Mellon Universitty
  1923.                Mark S. Lewis, Telebit
  1924.                David Lin
  1925.                David Lindemulder, AT&T/NCR
  1926.                Ben Lisowski, Sprint
  1927.                David Liu, Bell-Northern Research
  1928.                John Lunny, The Wollongong Group
  1929.                Robert C. Lushbaugh Martin, Marietta Energy Systems
  1930.                Michael Luufer, BBN
  1931.                Carl Madison, Star-Tek, Inc.
  1932.                Keith McCloghrie, Hughes LAN Systems
  1933.                Evan McGinnis, 3Com Corporation
  1934.                Bill McKenzie, IBM Corporation
  1935.                Donna McMaster, SynOptics Communications, Inc.
  1936.                John Medicke, IBM Corporation
  1937.                Doug Miller, Telebit
  1938.                Dave Minnich, FiberCom
  1939.                Mohammad Mirhakkak, MITRE
  1940.                Rohit Mital, Protools
  1941.  
  1942.  
  1943.  
  1944.  
  1945.  
  1946.                               Expires June 22, 1993            [Page 33]
  1947.  
  1948.  
  1949.  
  1950.  
  1951.  
  1952.           Draft               Manager to Manager MIB              Dec 92
  1953.  
  1954.  
  1955.                George Mouradian, AT&T Bell Labs
  1956.                Patrick Mullaney, Cabletron Systems
  1957.                Dan Myers, 3Com Corporation
  1958.                Rina Nathaniel, Rad Network Devices Ltd.
  1959.                Hien V. Nguyen, Sprint
  1960.                Mo Nikain
  1961.                Tom Nisbet
  1962.                William B. Norton, MERIT
  1963.                Steve Onishi, Wellfleet Communications, Inc.
  1964.                David T. Perkins, SynOptics Communications, Inc.
  1965.                Carl Powell, BBN
  1966.                Ilan Raab, SynOptics Communications, Inc.
  1967.                RIchard Ramons, AT&T
  1968.                Venkat D. Rangan, Metric Network Systems, Inc.
  1969.                Louise Reingold, Sprint
  1970.                Sam Roberts, Farallon Computing, Inc.
  1971.                Kary Robertson, Concord Communications, Inc.
  1972.                Dan Romascanu, Lannet Data Communications Ltd.
  1973.                Marshall T. Rose, Dover Beach Consulting, Inc.
  1974.                Shawn A. Routhier, Epilogue Technology Corporation
  1975.                Chris Rozman
  1976.                Asaf Rubissa, Fibronics
  1977.                Jon Saperia, Digital Equipment Corporation
  1978.                Michael Sapich
  1979.                Mike Scanlon, Interlan
  1980.                Sam Schaen, MITRE
  1981.                John Seligson, Ultra Network Technologies
  1982.                Paul A. Serice, Corporation for Open Systems
  1983.                Chris Shaw, Banyan Systems
  1984.                Timon Sloane
  1985.                Robert Snyder, Cisco Systems
  1986.                Joo Young Song
  1987.                Roy Spitier, Sprint
  1988.                Einar Stefferud, Network Management Associates
  1989.                John Stephens, Cayman Systems, Inc.
  1990.                Bob Stewart, Xyplex, Inc. (chair)
  1991.                Kaj Tesink, Bellcore
  1992.                Dean Throop, Data General
  1993.                Ahmet Tuncay, France Telecom-CNET
  1994.                Maurice Turcotte, Racal Datacom
  1995.                Warren Vik, INTERACTIVE Systems Corporation
  1996.                Yannis Viniotis
  1997.                Steve Waldbusser, CMU
  1998.                Timothy M. Walden, ACC
  1999.                Alice Wang, Sun Microsystems
  2000.  
  2001.  
  2002.  
  2003.  
  2004.  
  2005.                               Expires June 22, 1993            [Page 34]
  2006.  
  2007.  
  2008.  
  2009.  
  2010.  
  2011.           Draft               Manager to Manager MIB              Dec 92
  2012.  
  2013.  
  2014.                James Watt, Newbridge
  2015.                Luanne Waul, Timeplex
  2016.                Donald E. Westlake III, Digital Equipment Corporation
  2017.                Gerry White
  2018.                Bert Wijnen, IBM Corporation
  2019.                Peter Wilson, 3Com Corporation
  2020.                Steven Wong, Digital Equipment Corporation
  2021.                Randy Worzella, IBM Corporation
  2022.                Daniel Woycke, MITRE
  2023.                Honda Wu
  2024.                Jeff Yarnell, Protools
  2025.                Chris Young, Cabletron
  2026.                Kiho Yum, 3Com Corporation
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.                               Expires June 22, 1993            [Page 35]
  2065.  
  2066.  
  2067.  
  2068.  
  2069.  
  2070.           Draft               Manager to Manager MIB              Dec 92
  2071.  
  2072.  
  2073.           5.  References
  2074.  
  2075.           [1]  Information processing systems - Open Systems
  2076.                Interconnection - Specification of Abstract Syntax
  2077.                Notation One (ASN.1), International Organization for
  2078.                Standardization.  International Standard 8824, (December,
  2079.                1987).
  2080.  
  2081.           [2]  J.D. Case, K. McCloghrie, M.T. Rose, S.L. Waldbusser,
  2082.                Structure of Management Information for version 2 of the
  2083.                Simple Network Management Protocol (SNMPv2).  Internet-
  2084.                Draft, (December 22, 1992).                                |
  2085.  
  2086.           [3]  J.D. Case, K. McCloghrie, M.T. Rose, S.L. Waldbusser,
  2087.                Protocol Operations for version 2 of the Simple Network
  2088.                Management Protocol (SNMPv2).  Internet-Draft, (December   |
  2089.                22, 1992).                                                 |
  2090.  
  2091.           [4]  J.R. Davin, J.M. Galvin, K. McCloghrie, Administrative
  2092.                Model for version 2 of the Simple Network Management
  2093.                Protocol (SNMPv2).  Internet-Draft, (December 22, 1992).   |
  2094.  
  2095.           [5]  K. McCloghrie, J.R. Davin, J.M. Galvin, Party MIB for
  2096.                version 2 of the Simple Network Management Protocol
  2097.                (SNMPv2).  Internet-Draft, (December 22, 1992).            |
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  
  2118.  
  2119.  
  2120.  
  2121.  
  2122.  
  2123.                               Expires June 22, 1993            [Page 36]
  2124.  
  2125.  
  2126.  
  2127.  
  2128.  
  2129.           Draft               Manager to Manager MIB              Dec 92
  2130.  
  2131.  
  2132.           Table of Contents
  2133.  
  2134.  
  2135.           1 Introduction ..........................................    2
  2136.           1.1 A Note on Terminology ...............................    2
  2137.           2 Overview ..............................................    3
  2138.           2.1 A SNMPv2 Entity Acting in a Dual Role ...............    3
  2139.           2.2 Alarms, Events, and Notifications ...................    3
  2140.           2.3 Access Control ......................................    4
  2141.           3 Definitions ...........................................    6
  2142.           3.1 The Alarm Group .....................................    7
  2143.           3.1.1 Alarm-Related Notifications .......................   21
  2144.           3.2 The Event Group .....................................   22
  2145.           3.3 Conformance Information .............................   30
  2146.           3.3.1 Compliance Statements .............................   30
  2147.           3.3.2 Units of Conformance ..............................   30
  2148.           4 Acknowledgements ......................................   32
  2149.           5 References ............................................   36
  2150.  
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.                               Expires June 22, 1993            [Page 37]
  2183.  
  2184.